استلام حالة التسليم من خلال الويبهوك

في هذا القسم، سنقدم إرشادات حول كيفية إعداد DLR Webhook واستلام إيصالات التسليم من المشغلين.

تقدم يونيفونك خدمة تتبع حالة تسليم الرسائل النصية القصيرة (SMS) باستخدام حلول Webhook. Webhooks عبارة عن استدعاءات HTTPS يحددها المستخدم، ويتم تفعيلها عادة عند وقوع حدث ما، مثل استلام رسالة نصية قصيرة على هاتف المستخدم أو رسالة واردة عبر واتساب للأعمال. عند وقوع هذا الحدث، ترسل يونيفونك طلب HTTPS POST إلى عنوان URL الذي يحدده العميل لـ Webhook. يتم تتبع حالة تسليم الرسائل النصية القصيرة بناء على DLR (إيصال التسليم)، وهي إشارة تتلقاها يونيفونك من مشغلي شبكات الهاتف.

هناك إشارات DLR إيجابية وسلبية يمكننا استقبالها من مشغل شبكة الهاتف.

• إشارة DLR الإيجابية هي تأكيد على استلام الهاتف لرسالة نصية قصيرة. عادة، تعني هذه الإشارة أن المستخدم قد تلقى إشعارا بوصول رسالة نصية قصيرة عبر هاتفه. ولا تشير هذه الإشارة إلى ما إذا كان المستخدم قد فتح الرسالة وقرأها أم لا.

• إن DLR السلبي هو تأكيد على أن الرسالة النصية القصيرة لم يتم تسليمها إلى الجهاز المحمول لأسباب مختلفة خارجة عن سيطرة يونيفونك.

مثال ومن الأمثلة على أسباب تلقي DLR سلبي هو غياب المشترك، أي عندما يكون الهاتف خارج نطاق التغطية لمدة 48 ساعة أو أكثر، وقام مشغل الهاتف بإسقاط الرسالة. إذا كان جهاز المستخدم النهائي مطفأ، فسيتم محاولة إرسال الرسالة عند تشغيل الجهاز وقدرته على استقبال الرسائل مجددا. على سبيل المثال، سيتمكن الجهاز من استقبال الرسائل مرة أخرى عند دخوله منطقة التغطية أو إيقاف وضع الطيران.

ملاحظة قد لا يرسل لنا مشغل شبكة الهاتف إيصال التسليم للرسالة، وفي هذه الحالة، لا يتم تشغيل حالة التسليم عبر webhook.

للحصول على مزيد من المعلومات حول حالة التسليم، راجع قسم فهم تسليم الرسائل النصية القصيرة.

كيفية إعداد رابط ويبهوك DLR

في حسابك على موقع يونيفونك، انتقل الى المطورون ثم إدارة الويبهوك

ثم انقر على إضافة رابط ويبهوك جديد

أضف اسما لخطاف الويب، وعنوان URL لـ Endpoint التي سيتم إرسال رد الاتصال إليها، ثم انقر على "نشط"، ثم انقر على "إضافة حدث".

في قسم الأحداث، حدد المنتج : الرسائل النصية القصيرة و نوع الحدث: DLR

سيتم عرض حمولة webhook؛ ويمكن تعديلها لتلقي نسخة مخصصة بناء على المحددات ذات الصلة بعمية التكامل الخاصة بك.

وأخيرا، انقر على حفظ

طلب المحددات

• هذا مثال على حمولة طلب POST التي سترسلها شركة Unifonic إلى DLR Webhook للإشارة إلى نجاح تسليم الرسائل النصية القصيرة:

{
  "body": {
    "submitUnitCount": "1",
    "deliveredUnitCount": "1",
    "submitDate": "202402211640",
    "doneDate": "202402211641",
    "finalStatus": "DELIVRD",
    "errorCode": "000",
    "freeText": "hello",
    "destinationAddress": "9665534XXXXX",
    "correlationId": "correlationId",
    "messageId": "41000032776314"
  },
  "timeStamp": "2024-02-21T16:41:00+00:00",
  "eventName": "dlr",
  "productName": "sms",
  "accountId": "de6fb171-a55d-45e8-8be6-7df00865bacc"
}

• فيما يلي مثال على إيصال تسليم يشير إلى عدم التسليم من جانب المشغل:

{
  "body": {
    "submitUnitCount": "1",
    "deliveredUnitCount": "1",
    "submitDate": "202402211640",
    "doneDate": "202402211641",
    "finalStatus": "UNDELIV",
    "errorCode": "000",
    "freeText": "223203",
    "destinationAddress": "9665534XXXXX",
    "correlationId": "correlationId",
    "messageId": "41000032776314"
  },
  "timeStamp": "2024-02-21T16:41:00+00:00",
  "eventName": "dlr",
  "productName": "sms",
  "accountId": "de6fb171-a55d-45e8-8be6-7df00865bacc"
}